using System.Collections.Generic;
using System.Threading.Tasks;
using JGSY.CMS.LowCode.Platform.Application.DTOs;

namespace JGSY.CMS.LowCode.Platform.Application.Interfaces
{
    /// <summary>
    /// 角色管理应用服务接口。
    /// 提供角色的增删改查及角色权限分配等角色管理相关业务功能接口定义。
    /// </summary>
    public interface IRoleAppService
    {
        /// <summary>
        /// 获取所有角色
        /// </summary>
        /// <returns>角色列表</returns>
        Task<IEnumerable<RoleDto>> GetAllAsync();
        
        /// <summary>
        /// 根据ID获取角色
        /// </summary>
        /// <param name="id">角色标识符</param>
        /// <returns>角色信息</returns>
        Task<RoleDto?> GetByIdAsync(long id);
        
        /// <summary>
        /// 添加新角色
        /// </summary>
        /// <param name="dto">角色数据传输对象</param>
        /// <returns>添加任务</returns>
        Task AddAsync(RoleDto dto);
        
        /// <summary>
        /// 更新角色信息
        /// </summary>
        /// <param name="id">角色标识符</param>
        /// <param name="dto">角色数据传输对象</param>
        /// <returns>更新任务</returns>
        Task UpdateAsync(long id, RoleDto dto);
        
        /// <summary>
        /// 删除角色
        /// </summary>
        /// <param name="id">角色标识符</param>
        /// <returns>删除任务</returns>
        Task DeleteAsync(long id);
        
        /// <summary>
        /// 为角色分配权限
        /// </summary>
        /// <param name="roleId">角色标识符</param>
        /// <param name="permissionIds">权限标识符列表</param>
        /// <returns>分配任务</returns>
        Task AssignPermissionsAsync(long roleId, List<string> permissionIds);
        
        /// <summary>
        /// 获取角色的权限列表
        /// </summary>
        /// <param name="roleId">角色标识符</param>
        /// <returns>权限列表</returns>
        Task<IEnumerable<PermissionDto>> GetPermissionsAsync(long roleId);
    }
}
